home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 January / Macworld (1998-01).dmg / Shareware World / Info / For Developers / Utils / README < prev   
Text File  |  1997-10-28  |  5KB  |  128 lines
  1.  
  2. Utils README
  3.  
  4. Utils is a small app that simply makes Latitude's Apple Menu utilities, 
  5. like Copy Files and File Systems available for use. This is handy if you 
  6. have no other way to properly bring your application's resource files 
  7. to Rhapsody.
  8.  
  9. To build Utils:
  10.  
  11. 1. Organize Utils' files under your $LATITUDE_ROOT/Latitude.MacFiles/
  12.    Applications directory like so:
  13.  
  14.     Utils/
  15.         %Utils
  16.         Sources/
  17.             Makefile
  18.             main.c
  19.  
  20. 2. Build Utils by invoking make. From a Terminal window, do this:
  21.  
  22.     localhost> cd $LATITUDE_ROOT/Latitude.MacFiles/Applications/Utils/Sources
  23.     localhost> make
  24.  
  25.    You should see output similar to this:
  26.  
  27.    cc -Wall -no-precomp -O -D_LATITUDE_ -I. -I/usr/latitude/include/latitude 
  28.    -I/usr/latitude/include/CIncludes   -c main.c -o Rhapsody/main.o
  29.    cc -Wall -no-precomp -O -L/usr/latitude/lib  -o 
  30.    Rhapsody/Utils Rhapsody/main.o  -llg -framework AppKit
  31.  
  32.    Depending on the setting of your LATITUDE_ROOT environment variable, you 
  33.    may see slight differences. However, Utils should build successfully. If
  34.    not, check to see that your LATITUDE_ROOT environment variable is set
  35.    properly.
  36.  
  37. 3. You can now run Utils:
  38.  
  39.     localhost> Rhapsody/Utils
  40.  
  41.    The first time you run Utils, Latitude will ask you to locate Utils' 
  42.    resource file by presenting a Standard Get File Dialog. Use the dialog
  43.    to locate Latitude.MacFiles:Applications:Utils:Utils
  44.  
  45. Using Utils:
  46.  
  47. Utils gives you access to Latitude's File Systems and Copy Files dialogs which
  48. can be helpful in bringing your application resource files to Rhapsody. To
  49. do this:
  50.  
  51. 1. On a Mac, place your application's executable and any other support resource
  52.    files on a 1.4 Meg HFS formatted floppy. If your application is too big to
  53.    fit on a floppy, try using a resource file editor to remove any compiled
  54.    CODE resources that may be taking up lots of space. Also, be sure that your
  55.    application's executable resource fork contains a BNDL resource with your
  56.    application's signature.
  57.  
  58. 2. On Rhapsody, insert the floppy and wait a moment until you see the Apple 
  59.    floppy icon on your Rhapsody desktop.
  60.  
  61. 3. run Utils. From a Teminal window, 
  62.  
  63.     localhost> cd $LATITUDE_ROOT/Latitude.MacFiles/Applications/Utils/Sources
  64.     localhost> Rhapsody/Utils
  65.  
  66.  
  67. 4. Select Utils' icon so that you see only an Apple menu and File menu
  68.    in the menubar.
  69.  
  70. 5. Select Apple->File Systems. The File Systems dialog will appear.
  71.  
  72. 6. Press the "Floppy" button. "/dev/rfd0b" appears in the Unix Path text 
  73.    field. 
  74.  
  75. 7. Press the "Add" button. The File Systems dialog will disappear. 
  76.    The floppy is now mounted.
  77.  
  78. 8. Select Apple->Copy Files. 
  79.  
  80.    The Copy Files dialog will appear. In the top portion of the dialog, 
  81.    you will see a file list of the floppy's contents. You can double click 
  82.    on folders to enter them. When you select a file, it will be listed in 
  83.    the file list in the center of the dialog.  To copy whole folders, select 
  84.    the folder and press the "Add" button.
  85.  
  86. 9. Select your resource file(s) to be copied. 
  87.  
  88. 10. Select the destination directory to receive the copied file(s). 
  89.     Most likely, you will be placing these files in Latitude.MacFiles:
  90.     Applications:YourAppDir. You can use the popup menu located across
  91.     from the "Select destination directory:" label to jump directly to 
  92.     a particular volume.
  93.  
  94. 11. Press "Copy All". An alert will appear asking to verify the 
  95.     destination. Pressing "OK" will allow the copy to proceed. 
  96.     The Copy Files dialog will disappear once the copy is completed.
  97.  
  98.  
  99. If you copy any text files with this method, you will find that no
  100. CR/LF conversion has been done. By setting some options in Latitude's
  101. File Systems dialog, however, Latitude will perform CR/LF conversion on 
  102. Mac files of Finder type 'TEXT'. To do this:
  103.  
  104. 1. Select Apple->File Systems. The File Systems dialog appears.
  105.  
  106. 2. Click on the volume you will be copying files to from the "Hotlist 
  107.    Directories" list. 
  108.  
  109. 3. Press the "Options..." button. The UNIX File System Options dialog
  110.    appears.
  111.  
  112. 4. In the middle of the dialog, select the "UNIX style (LF)" setting for
  113.    the Disk representation of line breaks.
  114.  
  115. 5. In the bottom of the dialog, select the "All 'TEXT' files" setting.
  116.  
  117. 6. Press the "OK" button. The UNIX File System Options dialog disappears.
  118.  
  119. 7. Due to an updating bug, the File Systems dialog won't update itself so you'll
  120.    lose its contents. To move on, press return while the File Systems dialog
  121.    has focus. The File System dialog disappears.
  122.  
  123. 8. You may now use the Copy Files dialog to copy text files from a Mac floppy
  124.    into the volume you designated in the File Systems dialog. Latitude will
  125.    automatically perform CR/LF conversions for TEXT files that are copied.
  126.  
  127.  
  128.